home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3g / pathfind.z / pathfind
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppaaaatttthhhhffffiiiinnnndddd((((3333GGGG))))                                                      ppppaaaatttthhhhffffiiiinnnndddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd - search for named file in named directories
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  15.  
  16.      _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_p_a_t_h_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_n_a_m_e_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr
  17.          _****_m_o_d_e_))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd searches the directories named in _p_a_t_h for the file _n_a_m_e.  The
  21.      directories named in _p_a_t_h are separated by colons.  _m_o_d_e is a string of
  22.      option letters chosen from the set _rrrr_wwww_xxxx_ffff_bbbb_cccc_dddd_pppp_uuuu_gggg_kkkk_ssss:
  23.                             Letter   Meaning
  24.                             __________________________
  25.                               _rrrr      readable
  26.                               _wwww      writable
  27.                               _xxxx      executable
  28.                               _ffff      normal file
  29.                               _bbbb      block special
  30.                               _cccc      character special
  31.                               _dddd      directory
  32.                               _pppp      FIFO (pipe)
  33.                               _uuuu      set user ID bit
  34.                               _gggg      set group ID bit
  35.                               _kkkk      sticky bit
  36.                               _ssss      size nonzero
  37.      Options read, write, and execute are checked relative to the real (not
  38.      the effective) user ID and group ID of the current process.
  39.  
  40.      If the file _n_a_m_e, with all the characteristics specified by _m_o_d_e, is
  41.      found in any of the directories specified by _p_a_t_h, then _pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd returns
  42.      a pointer to a string containing the member of _p_a_t_h, followed by a slash
  43.      character (_////), followed by _n_a_m_e.
  44.  
  45.      If _n_a_m_e begins with a slash, it is treated as an absolute path name, and
  46.      _p_a_t_h is ignored.
  47.  
  48.      An empty _p_a_t_h member is treated as the current directory.  rather, the
  49.      unadorned _n_a_m_e is returned.
  50.  
  51. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  52.      To find the _llll_ssss command using the _PPPP_AAAA_TTTT_HHHH environment variable:
  53.  
  54.           _pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd _((((_gggg_eeee_tttt_eeee_nnnn_vvvv _((((_""""_PPPP_AAAA_TTTT_HHHH_""""_))))_,,,, _""""_llll_ssss_""""_,,,, _""""_rrrr_xxxx_""""_))))
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      _ssss_hhhh(1), _tttt_eeee_ssss_tttt(1), _aaaa_cccc_cccc_eeee_ssss_ssss(2), _mmmm_kkkk_nnnn_oooo_dddd(2), _ssss_tttt_aaaa_tttt(2), _gggg_eeee_tttt_eeee_nnnn_vvvv(3C)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppaaaatttthhhhffffiiiinnnndddd((((3333GGGG))))                                                      ppppaaaatttthhhhffffiiiinnnndddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      If no match is found, _pppp_aaaa_tttt_hhhh_nnnn_aaaa_mmmm_eeee returns a null pointer, _((((_((((_cccc_hhhh_aaaa_rrrr _****_)))) _0000_)))).
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      The string pointed to by the returned pointer is stored in a static area
  79.      that is reused on subsequent calls to _pppp_aaaa_tttt_hhhh_ffff_iiii_nnnn_dddd.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.